Configuring a Custom Vector Basemap

Procedure: How to Add a Custom Vector Basemap

Click Workspace on the Reporting Server Web Console sidebar.
Click Geo Services on the ribbon and select Edit Configuration.
The GEO configuration editor opens.
Select Basemap from the Object drop-down list.
Click Add on the toolbar, as shown in the following image.

The Create a BASEMAP page opens, as shown in the following image.
Enter or select values for the following properties.
name

Is the name of the basemap.

icon

Is the URL to the thumbnail for the customized basemap that will appear on the Background drop-down list in the WebFOCUS tools or the Change Basemap map widget.

title

Is a title to display on the Basemap drop-down list in the WebFOCUS tools or the Change Basemap map widget.

type

Select vector for a vector basemap.

url

Is the URL to the map service that provides the basemap. The map service URL can be copied from the URL field on the page showing the map.

Once you enter the URL, you can click Verify to verify that the URL points to the correct map service.

addon_json
Enter the basemap map service URLs and Style URLs needed for rendering the map. The map can consist of an array of layers, each with a URL and its style URL. The style URL for each layer can be found by clicking View Style on the page showing the map layer. The map service URL for each layer can be copied from the URL field on the page showing the map layer. Enter the information in the following format.
```
  {"baseMapLayers":
   [
     {"url": "url_to_map_service", "styleUrl": "url_to_style"},
     {"url": "url_to_map_service", "styleUrl": "url_to_style"},
      ...
   ]
  }
```
Enter the baseMapLayers object in the text box.

Note: If the vector basemap has multiple layers, its page on ArcGIS online will have links to each layer.
Click OK to close the Create a BASEMAP page.

You return to the GEO configuration editor.
Click Save to save the customized basemap.

The customized basemap is added to the list of basemaps in the GEO configuration editor.

Example: Configuring the Nova Vector Basemap

The Esri component in this example uses the following request, named customer_locations.fex.

TABLE FILE WF_RETAIL_LITE
PRINT
     ID_CUSTOMER
     COGS_US
	 QUANTITY_SOLD
     COMPUTE LONGITUDE/D12.2 =CUSTOMER_LONGITUDE;
     COMPUTE LATITUDE/D12.2 = CUSTOMER_LATITUDE;
BY  STATE_PROV_NAME
BY  ID_CUSTOMER NOPRINT
WHERE COUNTRY_NAME EQ 'United States';
ON TABLE NOTOTAL
ON TABLE PCHOLD FORMAT XML
END

The Settings panel for the Esri map uses this request for a Point of Interest layer, as shown in the following image.

The following steps are needed to determine the properties associated with the Nova vector basemap.

Go to the following URL for the Nova basemap.
https://www.arcgis.com/home/item.html?id=75f4dfdff19e445395653121a95a85db. The Nova basemap page is shown in the following image.

In the addon_json syntax, you need the styleUrl for each basemap URL defined in the vector basemap.
Click the View Style button to retrieve the styleUrl. In this case, it is the following URL.
https://www.arcgis.com/sharing/rest/content/items/75f4dfdff19e445395653121a95a85db/resources/styles/root.json?f=pjson
Add the following URL for the Esri vector map service in both the url field in the GEO configuration editor and in the addon_json syntax for this basemap. You can copy this location from the URL field on the lower right of the Nova basemap page.
https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer
The icon needs to be a URL. This example uses the one referenced in the thumbnail of the webmap, which is the following URL (retrieved by right-clicking the thumbnail image at the top of the page and copying the image location).
http://www.arcgis.com/sharing/rest/content/items/75f4dfdff19e445395653121a95a85db/info/thumbnail/Nova.png

Add these properties in the GEO configuration editor to define the Nova vector basemap, which consists of a single layer. Add the name, type, and a title, as follows.

name: Nova

icon: http://www.arcgis.com/sharing/rest/content/items/75f4dfdff19e445395653121a95a85db/info/thumbnail/Nova.png

title: Nova

url: https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer

addon_json:

{"baseMapLayers":
[
{"url": "https://basemaps.arcgis.com/arcgis/rest/services/World_Basemap_v2/VectorTileServer",
 "styleUrl": "http://www.arcgis.com/sharing/rest/content/items/75f4dfdff19e445395653121a95a85db/resources/styles/root.json"
 }
]
}

The following image shows the Create a BASEMAP page for configuring the Nova vector basemap in the Reporting Server GEO configuration editor.

After clicking OK, then Save, the custom vector basemap becomes available for selection in the Properties panel for the Esri map component, as shown in the following image.

Running the HTML page generates the following map, with the Nova vector basemap as the base layer.

The Nova vector basemap is also available in the Change Basemap widget, as shown in the following image.

	WebFOCUS